Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Docs][Maps] Troublesooting common Mapes File Upload issues #174476

Merged
merged 7 commits into from
Feb 1, 2024

Conversation

jsanz
Copy link
Member

@jsanz jsanz commented Jan 8, 2024

Fixes #135319

Adds a new section to the Troubleshooting addressing how to improve geospatial datasets locally before working with Kibana Maps File Upload to increase the chances of a successful operation.

  • Converting a dataset into a GeoJSON or Shapefile with ogr2ogr
  • Transforming a dataset into WGS84 with ogr2ogr
  • Exploding a multigeometry dataset into parts with ogr2ogr
  • Reducing the precision of a dataset with ogr2ogr
  • Simplifying region datasets with mapshaper
  • Options to clean invalid geometries with ogr2ogr and mapshaper

Copy link
Contributor

github-actions bot commented Jan 8, 2024

Documentation preview:

@jsanz jsanz added release_note:skip Skip the PR/issue when compiling release notes docs backport:prev-minor Backport to (8.x) the previous minor version (i.e. one version back from main) Feature:Maps labels Jan 8, 2024
@jsanz jsanz marked this pull request as ready for review January 23, 2024 17:47
@jsanz jsanz requested review from nreese and nickpeihl January 23, 2024 17:47
@jsanz
Copy link
Member Author

jsanz commented Jan 23, 2024

@nickpeihl @nreese let me know if there are other missing workflows I should consider here for this section.

Copy link
Contributor

@nreese nreese left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These are all great examples of what is possible. Thanks for putting these together.

Instead of adding these to the trouble shooting section, what do you think about putting them on their own page that is nested under "Import geospatial data"? That way the be below menu would have another section "Clean geospatial data".

Screenshot 2024-01-24 at 8 27 45 AM

@jsanz
Copy link
Member Author

jsanz commented Jan 24, 2024

These are all great examples of what is possible. Thanks for putting these together.

Instead of adding these to the trouble shooting section, what do you think about putting them on their own page that is nested under "Import geospatial data"? That way the be below menu would have another section "Clean geospatial data".

Thanks for the suggestion! I've moved it to the import section, let's see how it looks and I'll tag you again for review.

@jsanz
Copy link
Member Author

jsanz commented Jan 24, 2024

@jsanz jsanz requested a review from nreese January 24, 2024 16:39
@jsanz jsanz added the Team:Presentation Presentation Team for Dashboard, Input Controls, and Canvas label Jan 26, 2024
@elasticmachine
Copy link
Contributor

Pinging @elastic/kibana-presentation (Team:Presentation)

Copy link
Contributor

@nreese nreese left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks great. I love all of the examples

docs/maps/clean-data.asciidoc Outdated Show resolved Hide resolved
docs/maps/clean-data.asciidoc Outdated Show resolved Hide resolved
docs/maps/clean-data.asciidoc Outdated Show resolved Hide resolved
docs/maps/clean-data.asciidoc Outdated Show resolved Hide resolved
docs/maps/clean-data.asciidoc Outdated Show resolved Hide resolved
docs/maps/clean-data.asciidoc Outdated Show resolved Hide resolved
docs/maps/index.asciidoc Show resolved Hide resolved
docs/maps/clean-data.asciidoc Outdated Show resolved Hide resolved
@jsanz jsanz requested review from nreese and nickpeihl January 31, 2024 11:37
@jsanz
Copy link
Member Author

jsanz commented Jan 31, 2024

@nickpeihl @nreese thanks for your suggestions and fixes 🙇. I've incorporated all of them at a6606a9 and a649b88.

Copy link
Contributor

@nreese nreese left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. Thank you for adding these examples. This is a great guide for users

Copy link
Member

@nickpeihl nickpeihl left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm! You have added great examples and this should be very useful for our geospatial users!

@jsanz jsanz merged commit 9b5d040 into elastic:main Feb 1, 2024
7 checks passed
@jsanz jsanz deleted the docs/maps/troubleshooting-upload branch February 1, 2024 09:27
kibanamachine pushed a commit to kibanamachine/kibana that referenced this pull request Feb 1, 2024
…174476)

Fixes elastic#135319

Adds a new section to the
[Troubleshooting](https://www.elastic.co/guide/en/kibana/current/maps-troubleshooting.html)
addressing how to improve geospatial datasets locally before working
with Kibana Maps File Upload to increase the chances of a successful
operation.

* Converting a dataset into a GeoJSON or Shapefile with ogr2ogr
* Transforming a dataset into WGS84 with ogr2ogr
* Exploding a multigeometry dataset into parts with ogr2ogr
* Reducing the precision of a dataset with ogr2ogr
* Simplifying region datasets with mapshaper
* Options to clean invalid geometries with ogr2ogr and mapshaper

---------

Co-authored-by: Nick Peihl <[email protected]>
(cherry picked from commit 9b5d040)
@kibanamachine
Copy link
Contributor

💚 All backports created successfully

Status Branch Result
8.12

Note: Successful backport PRs will be merged automatically after passing CI.

Questions ?

Please refer to the Backport tool documentation

kibanamachine added a commit that referenced this pull request Feb 1, 2024
…174476) (#176042)

# Backport

This will backport the following commits from `main` to `8.12`:
- [[Docs][Maps] Troublesooting common Mapes File Upload issues
(#174476)](#174476)

<!--- Backport version: 9.4.3 -->

### Questions ?
Please refer to the [Backport tool
documentation](https://github.com/sqren/backport)

<!--BACKPORT [{"author":{"name":"Jorge
Sanz","email":"[email protected]"},"sourceCommit":{"committedDate":"2024-02-01T09:27:25Z","message":"[Docs][Maps]
Troublesooting common Mapes File Upload issues (#174476)\n\nFixes
#135319\r\n\r\nAdds a new section to
the\r\n[Troubleshooting](https://www.elastic.co/guide/en/kibana/current/maps-troubleshooting.html)\r\naddressing
how to improve geospatial datasets locally before working\r\nwith Kibana
Maps File Upload to increase the chances of a
successful\r\noperation.\r\n\r\n* Converting a dataset into a GeoJSON or
Shapefile with ogr2ogr\r\n* Transforming a dataset into WGS84 with
ogr2ogr\r\n* Exploding a multigeometry dataset into parts with
ogr2ogr\r\n* Reducing the precision of a dataset with ogr2ogr\r\n*
Simplifying region datasets with mapshaper\r\n* Options to clean invalid
geometries with ogr2ogr and
mapshaper\r\n\r\n---------\r\n\r\nCo-authored-by: Nick Peihl
<[email protected]>","sha":"9b5d040e5ecfa915cc80beebeac63179a6d82830","branchLabelMapping":{"^v8.13.0$":"main","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["Team:Presentation","release_note:skip","docs","backport:prev-minor","Feature:Maps","v8.13.0"],"title":"[Docs][Maps]
Troublesooting common Mapes File Upload
issues","number":174476,"url":"https://github.com/elastic/kibana/pull/174476","mergeCommit":{"message":"[Docs][Maps]
Troublesooting common Mapes File Upload issues (#174476)\n\nFixes
#135319\r\n\r\nAdds a new section to
the\r\n[Troubleshooting](https://www.elastic.co/guide/en/kibana/current/maps-troubleshooting.html)\r\naddressing
how to improve geospatial datasets locally before working\r\nwith Kibana
Maps File Upload to increase the chances of a
successful\r\noperation.\r\n\r\n* Converting a dataset into a GeoJSON or
Shapefile with ogr2ogr\r\n* Transforming a dataset into WGS84 with
ogr2ogr\r\n* Exploding a multigeometry dataset into parts with
ogr2ogr\r\n* Reducing the precision of a dataset with ogr2ogr\r\n*
Simplifying region datasets with mapshaper\r\n* Options to clean invalid
geometries with ogr2ogr and
mapshaper\r\n\r\n---------\r\n\r\nCo-authored-by: Nick Peihl
<[email protected]>","sha":"9b5d040e5ecfa915cc80beebeac63179a6d82830"}},"sourceBranch":"main","suggestedTargetBranches":[],"targetPullRequestStates":[{"branch":"main","label":"v8.13.0","branchLabelMappingKey":"^v8.13.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/174476","number":174476,"mergeCommit":{"message":"[Docs][Maps]
Troublesooting common Mapes File Upload issues (#174476)\n\nFixes
#135319\r\n\r\nAdds a new section to
the\r\n[Troubleshooting](https://www.elastic.co/guide/en/kibana/current/maps-troubleshooting.html)\r\naddressing
how to improve geospatial datasets locally before working\r\nwith Kibana
Maps File Upload to increase the chances of a
successful\r\noperation.\r\n\r\n* Converting a dataset into a GeoJSON or
Shapefile with ogr2ogr\r\n* Transforming a dataset into WGS84 with
ogr2ogr\r\n* Exploding a multigeometry dataset into parts with
ogr2ogr\r\n* Reducing the precision of a dataset with ogr2ogr\r\n*
Simplifying region datasets with mapshaper\r\n* Options to clean invalid
geometries with ogr2ogr and
mapshaper\r\n\r\n---------\r\n\r\nCo-authored-by: Nick Peihl
<[email protected]>","sha":"9b5d040e5ecfa915cc80beebeac63179a6d82830"}}]}]
BACKPORT-->

Co-authored-by: Jorge Sanz <[email protected]>
fkanout pushed a commit to fkanout/kibana that referenced this pull request Feb 7, 2024
…174476)

Fixes elastic#135319

Adds a new section to the
[Troubleshooting](https://www.elastic.co/guide/en/kibana/current/maps-troubleshooting.html)
addressing how to improve geospatial datasets locally before working
with Kibana Maps File Upload to increase the chances of a successful
operation.

* Converting a dataset into a GeoJSON or Shapefile with ogr2ogr
* Transforming a dataset into WGS84 with ogr2ogr
* Exploding a multigeometry dataset into parts with ogr2ogr
* Reducing the precision of a dataset with ogr2ogr
* Simplifying region datasets with mapshaper
* Options to clean invalid geometries with ogr2ogr and mapshaper

---------

Co-authored-by: Nick Peihl <[email protected]>
CoenWarmer pushed a commit to CoenWarmer/kibana that referenced this pull request Feb 15, 2024
…174476)

Fixes elastic#135319

Adds a new section to the
[Troubleshooting](https://www.elastic.co/guide/en/kibana/current/maps-troubleshooting.html)
addressing how to improve geospatial datasets locally before working
with Kibana Maps File Upload to increase the chances of a successful
operation.

* Converting a dataset into a GeoJSON or Shapefile with ogr2ogr
* Transforming a dataset into WGS84 with ogr2ogr
* Exploding a multigeometry dataset into parts with ogr2ogr
* Reducing the precision of a dataset with ogr2ogr
* Simplifying region datasets with mapshaper
* Options to clean invalid geometries with ogr2ogr and mapshaper

---------

Co-authored-by: Nick Peihl <[email protected]>
fkanout pushed a commit to fkanout/kibana that referenced this pull request Mar 4, 2024
…174476)

Fixes elastic#135319

Adds a new section to the
[Troubleshooting](https://www.elastic.co/guide/en/kibana/current/maps-troubleshooting.html)
addressing how to improve geospatial datasets locally before working
with Kibana Maps File Upload to increase the chances of a successful
operation.

* Converting a dataset into a GeoJSON or Shapefile with ogr2ogr
* Transforming a dataset into WGS84 with ogr2ogr
* Exploding a multigeometry dataset into parts with ogr2ogr
* Reducing the precision of a dataset with ogr2ogr
* Simplifying region datasets with mapshaper
* Options to clean invalid geometries with ogr2ogr and mapshaper

---------

Co-authored-by: Nick Peihl <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
backport:prev-minor Backport to (8.x) the previous minor version (i.e. one version back from main) docs Feature:Maps release_note:skip Skip the PR/issue when compiling release notes Team:Presentation Presentation Team for Dashboard, Input Controls, and Canvas v8.12.1 v8.13.0
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[Maps] Add to troubleshoot section details on cleaning data before uploading
5 participants